home *** CD-ROM | disk | FTP | other *** search
/ IRIX Patches 1995 December / SGI IRIX Patches 1995 Dec.iso / relnotes / patchSG0000749 / ch1.z / ch1
Text File  |  1995-11-17  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        1.  _P_a_t_c_h__S_G_0_0_0_0_7_4_9__R_e_l_e_a_s_e__N_o_t_e
  9.  
  10.        This release note describes patch SG0000749 to IRIX ONC3
  11.        5.3.
  12.  
  13.        1.1  _S_u_p_p_o_r_t_e_d__H_a_r_d_w_a_r_e__P_l_a_t_f_o_r_m_s
  14.  
  15.        This patch contains bug fixes for all hardware and software
  16.        configurations.  The software cannot be installed on other
  17.        configurations.
  18.  
  19.        1.2  _S_u_p_p_o_r_t_e_d__S_o_f_t_w_a_r_e__P_l_a_t_f_o_r_m_s
  20.  
  21.        This patch contains bug fixes for all hardware and software
  22.        configurations.  The software cannot be installed on other
  23.        configurations.
  24.  
  25.        1.3  _B_u_g_s__F_i_x_e_d__b_y__P_a_t_c_h__S_G_0_0_0_0_7_4_9
  26.  
  27.        This patch contains fixes for the following bugs in IRIX
  28.        ONC3 5.3.  Bug numbers from Silicon Graphics bug tracking
  29.        system are included for reference.
  30.  
  31.           +o Bug report 259761 -- cachefs hangs in sync
  32.  
  33.             Due to a deadlock which can occur when cachefs_fsync is
  34.             called with the FSYNC_WAIT flag, cachefs may hang
  35.             during a sync operation.
  36.  
  37.           +o Bug report 252778 -- excessive memory use by cachefs
  38.  
  39.             CacheFS excessively allocates kernel memory.  Much of
  40.             the memory allocated is not returned to the system
  41.             until all CacheFS file systems have been unmounted.
  42.  
  43.             This patch changes CacheFS so that it will return
  44.             memory to the system by freeing cnode data.  This may
  45.             be controlled through two tunable parameters:
  46.             _m_a_x_c_n_o_d_e_s and _c_a_c_h_e_f_s__m_a_x__l_r_u.  The tunable parameter
  47.             _m_a_x_c_n_o_d_e_s has been introduced with this patch.  It
  48.             determines the upper bound for cnode allocation.  This
  49.             is what might be called a "soft" boundary.  CacheFS may
  50.             allocate more than this many cnodes, but once the upper
  51.             bound has been exceeded, inactive cnodes will be freed.
  52.  
  53.             Tuning should be done by setting _m_a_x_c_n_o_d_e_s and
  54.             _c_a_c_h_e_f_s__m_a_x__l_r_u to low values (such as 100 and 10
  55.             respectively), with _m_a_x_c_n_o_d_e_s being greater than
  56.             _c_a_c_h_e_f_s__m_a_x__l_r_u.  These numbers should be increased
  57.             until the desired combination of performance and memory
  58.             usage is obtained.  Note that _m_a_x_c_n_o_d_e_s may be set to
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.             be less than or equal to _c_a_c_h_e_f_s__m_a_x__l_r_u.  Doing so
  75.             will cause no problems.  It will, however, result in
  76.             all cnodes not on the lru list being freed (i.e., their
  77.             storage returned to the system).
  78.  
  79.             Take care to consider file access patterns when tuning.
  80.             Commands such as _d_u(1) and _f_i_n_d(1) will have very
  81.             different access patterns from _m_a_k_e(1), _c_c(1) and
  82.             _l_d(1).
  83.  
  84.             The above tuning method has been suggested in order
  85.             that fragmentation of the kernel heap may be avoided.
  86.             This will minimize both the total memory allocated to
  87.             the kernel and the amount used by CacheFS.  Setting
  88.             _m_a_x_c_n_o_d_e_s and _c_a_c_h_e_f_s__m_a_x__l_r_u to higher values and then
  89.             lowering them is less effective at keeping kernel
  90.             memory usage low.  This is because the data allocated
  91.             by CacheFS will be distributed throughout a larger heap
  92.             area.
  93.  
  94.        1.4  _S_u_b_s_y_s_t_e_m_s__I_n_c_l_u_d_e_d__i_n__P_a_t_c_h__S_G_0_0_0_0_7_4_9
  95.  
  96.        This patch release includes these subsystems:
  97.  
  98.           +o patchSG0000749.onc3_eoe_sw.cachefs
  99.  
  100.  
  101.        1.5  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_s_t_r_u_c_t_i_o_n_s
  102.  
  103.        Because you want to install only the patches for problems
  104.        you have encountered, patch software is not installed by
  105.        default. After reading the descriptions of the bugs fixed in
  106.        this patch (see Section 1.3), determine the patches that
  107.        meet your specific needs.
  108.  
  109.        If, after reading Sections 1.1 and 1.2 of these release
  110.        notes, you are unsure whether your hardware and software
  111.        meet the requirements for installing a particular patch, run
  112.        _i_n_s_t.
  113.  
  114.        Patch software is installed like any other Silicon Graphics
  115.        software product.  Follow the instructions in your _S_o_f_t_w_a_r_e
  116.        _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e to bring up the miniroot
  117.        form of the software installation tools.
  118.  
  119.        Follow these steps to select a patch for installation:
  120.  
  121.          1.  At the Inst>prompt, type
  122.  
  123.              iiiinnnnssssttttaaaallllllll ppppaaaattttcccchhhhSSSSGGGG_x_x_x_x_x_x_x
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.              where _x_x_x_x_x_x_x is the patch number.
  141.  
  142.          2.  Select the desired patches for installation.
  143.  
  144.          3.  Initiate the installation sequence. Type
  145.  
  146.              IIIInnnnsssstttt>>>> ggggoooo
  147.  
  148.          4.  You may find that two patches have been marked as
  149.              incompatible.  If this occurs, you must deselect one
  150.              of the patches.
  151.  
  152.              IIIInnnnsssstttt>>>> kkkkeeeeeeeepppp ppppaaaattttcccchhhhSSSSGGGG_x_x_x_x_x_x_x
  153.  
  154.              where _x_x_x_x_x_x_x is the patch number.
  155.  
  156.          5.  After completing the installation process, exit the
  157.              _i_n_s_t program by typing
  158.  
  159.              IIIInnnnsssstttt>>>> qqqquuuuiiiitttt
  160.  
  161.  
  162.        To remove a patch, use the _v_e_r_s_i_o_n_s _r_e_m_o_v_e command as you
  163.        would for any other software subsystem.  The removal process
  164.        reinstates the original version of software unless you have
  165.        specifically removed the patch history from your system.
  166.  
  167.        vvvveeeerrrrssssiiiioooonnnnssss rrrreeeemmmmoooovvvveeee ppppaaaattttcccchhhhSSSSGGGG_x_x_x_x_x_x_x
  168.  
  169.        where _x_x_x_x_x_x_x is the patch number.
  170.  
  171.        To keep a patch but increase your disk space, use the
  172.        _v_e_r_s_i_o_n_s _r_e_m_o_v_e_h_i_s_t command to remove the patch history.
  173.  
  174.        vvvveeeerrrrssssiiiioooonnnnssss rrrreeeemmmmoooovvvveeeehhhhiiiisssstttt ppppaaaattttcccchhhhSSSSGGGG_x_x_x_x_x_x_x
  175.  
  176.        where _x_x_x_x_x_x_x is the patch number.
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.